Skip to content

docs(ensnode.io): unify LinkCard hover styles in colored asides#2233

Open
notrab wants to merge 4 commits into
mainfrom
docs/linkcard-aside-hover-styles
Open

docs(ensnode.io): unify LinkCard hover styles in colored asides#2233
notrab wants to merge 4 commits into
mainfrom
docs/linkcard-aside-hover-styles

Conversation

@notrab
Copy link
Copy Markdown
Member

@notrab notrab commented Jun 1, 2026

Lite PR

Tip: Review docs on the ENSNode PR process

Summary

CleanShot 2026-06-01 at 12 34 14 CleanShot 2026-06-01 at 12 33 45@2x CleanShot 2026-06-01 at 12 33 49@2x CleanShot 2026-06-01 at 12 48 44@2x

Why

  • Why this change exists. Link to related GitHub issues where relevant.

Testing

  • How this was tested.
  • If you didn't test it, say why.

Notes for Reviewer (Optional)

  • Anything non-obvious or worth a heads-up.

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

Copilot AI review requested due to automatic review settings June 1, 2026 11:50
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Jun 1, 2026

⚠️ No Changeset found

Latest commit: 859dee0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Jun 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
admin.ensnode.io Ready Ready Preview, Comment Jun 3, 2026 7:50am
enskit-react-example.ensnode.io Ready Ready Preview, Comment Jun 3, 2026 7:50am
ensnode.io Ready Ready Preview, Comment Jun 3, 2026 7:50am
ensrainbow.io Ready Ready Preview, Comment Jun 3, 2026 7:50am

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 1, 2026

Review Change Stack

Warning

Review limit reached

@notrab, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 57 minutes and 14 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 34ca15aa-1ec8-4455-bda7-e6fe734b6eee

📥 Commits

Reviewing files that changed from the base of the PR and between 4774915 and 859dee0.

📒 Files selected for processing (1)
  • docs/ensnode.io/src/styles/starlight.css
📝 Walkthrough

Walkthrough

Updated starlight.css to add aside-card design tokens, refine .sl-link-card transitions and hover color wiring, narrow the markdown link hover selector to exclude link-cards, and apply variant-specific card/background/border and title-hover tokens for tip, danger, caution, and note asides.

Changes

Starlight Styling Updates

Layer / File(s) Summary
Design tokens for aside card variants
docs/ensnode.io/src/styles/starlight.css
Added :root CSS variables for aside card backgrounds, borders, normal/hover states, and per-variant title-hover colors for tip, danger, caution, and note.
Link card transitions and hover color wiring
docs/ensnode.io/src/styles/starlight.css
Refined .sl-link-card with explicit transition rules for nested .icon and .title, and wired hover colors to --sl-color-accent (icon) and --sl-color-text-accent (title).
Markdown link hover selector narrowing
docs/ensnode.io/src/styles/starlight.css
Narrowed the global a:hover override so it does not apply to links inside .sl-link-card descendants while keeping existing hover accent text behavior for other markdown links.
Aside variant-specific link-card styling
docs/ensnode.io/src/styles/starlight.css
Updated .starlight-aside--tip, --danger, --caution, and --note to apply variant-specific card background/border tokens (normal and hover) and per-variant *-card-title-hover tokens; icon hover color now comes from shared .sl-link-card:hover .icon rule.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • namehash/ensnode#2218: Overlaps on starlight.css changes for aside variants and nested sl-link-card background/border/title/icon handling.
  • namehash/ensnode#2213: Related edits to markdown/anchor hover behavior and link-hover handling within sl-link-card contexts.
  • namehash/ensnode#2215: Related adjustments to .sl-link-card hover styling and nested element color behaviors.

Suggested labels

docs

Poem

🐰 A hop through tokens, borders, and light,

Cards glow on hover, icons gleam bright,
Tip, danger, caution, and note take their place,
Titles and links find their color and grace,
A tiny rabbit applauds this tidy design delight.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description follows the template structure but lacks substantive content in key sections: 'Why' and 'Testing' are empty placeholders, and 'Summary' contains only screenshots without explanatory text. Complete the 'Why' section with rationale and any related issues, and add testing details to demonstrate how the hover style changes were validated across the aside variants.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: unifying LinkCard hover styles in colored asides, which aligns with the CSS modifications summarized.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/linkcard-aside-hover-styles

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the docs site’s Starlight theme CSS to make LinkCard hover styling consistent inside colored asides (tip/danger/caution), aligning background/border/title/icon hover behavior.

Changes:

  • Added aside-specific CSS custom properties for LinkCard background/border/title hover colors.
  • Added hover color transitions for LinkCard icons and titles.
  • Adjusted the markdown link hover override to avoid interfering with LinkCard hover styling (needs a small selector fix—see PR comment).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ensnode.io/src/styles/starlight.css Outdated
Copy link
Copy Markdown
Contributor

@vercel vercel Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional Suggestion:

The .starlight-aside--note section is missing unified LinkCard hover styles that were added to tip, danger, and caution asides, violating the PR's goal to unify hover behavior across all aside types.

Fix on Vercel

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/ensnode.io/src/styles/starlight.css (1)

651-665: 🧹 Nitpick | 🔵 Trivial | ⚡ Quick win

Consider applying the token-based approach to the note variant for consistency.

The tip, danger, and caution aside variants now use dedicated tokens for link-card backgrounds, borders, and hover states, but the note variant retains static styling without hover background/border changes. While this may be intentional, it creates an inconsistency where link-cards in note asides will fall back to the default hover behavior (lines 210-213) rather than variant-specific styling.

For maintainability and consistent user experience, consider defining --aside-note-card-* tokens and applying the same pattern used for the other three variants.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/ensnode.io/src/styles/starlight.css` around lines 651 - 665, The
.starlight-aside--note block currently only sets --aside-color and styles
.sl-link-card, .title, and .icon but doesn't define or apply variant-specific
card tokens, causing note link-cards to use the default hover styles; add
dedicated tokens like --aside-note-card-bg, --aside-note-card-border,
--aside-note-card-hover-bg (mirroring the tip/danger/caution pattern) and apply
them to .starlight-aside--note .sl-link-card for background, border-color, and
hover state so the note variant follows the same token-based styling as the
other aside variants.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@docs/ensnode.io/src/styles/starlight.css`:
- Around line 651-665: The .starlight-aside--note block currently only sets
--aside-color and styles .sl-link-card, .title, and .icon but doesn't define or
apply variant-specific card tokens, causing note link-cards to use the default
hover styles; add dedicated tokens like --aside-note-card-bg,
--aside-note-card-border, --aside-note-card-hover-bg (mirroring the
tip/danger/caution pattern) and apply them to .starlight-aside--note
.sl-link-card for background, border-color, and hover state so the note variant
follows the same token-based styling as the other aside variants.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: ee7f1f75-d8ac-43cb-bfe0-a14fcc69b08c

📥 Commits

Reviewing files that changed from the base of the PR and between 63ce1af and 815f40e.

📒 Files selected for processing (1)
  • docs/ensnode.io/src/styles/starlight.css

@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io June 1, 2026 12:08 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io June 1, 2026 12:08 Inactive
@notrab notrab marked this pull request as ready for review June 1, 2026 13:46
@notrab notrab requested a review from a team as a code owner June 1, 2026 13:46
Copilot AI review requested due to automatic review settings June 1, 2026 13:46
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread docs/ensnode.io/src/styles/starlight.css
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Jun 1, 2026

Greptile Summary

This PR unifies the hover and resting styles for sl-link-card elements inside all four Starlight aside types (tip, danger, caution, note). It introduces a set of CSS custom properties for per-aside tinted backgrounds, borders, and title colors, and applies them consistently across all aside variants.

  • Adds 20 new CSS custom properties (--aside-*-card-bg, --aside-*-card-bg-hover, --aside-*-card-border, --aside-*-card-border-hover, --aside-*-card-title-hover) for all four aside types, derived via color-mix() from each aside's accent color.
  • Applies resting-state background-color/border-color and hover-state background, border, and title-color to .sl-link-card inside all four aside selectors, replacing the previous incomplete coverage.
  • Adds transition: color 0.2s ease-in-out globally to .sl-link-card .title and .sl-link-card .icon, and updates the .sl-markdown-content a:hover exclusion list to also skip .sl-link-card and its descendants so the generic link-hover color no longer interferes.

Confidence Score: 5/5

Pure CSS change scoped to documentation site styles; no logic, data, or runtime impact.

The change is entirely cosmetic CSS: new custom properties derived from existing aside colors via color-mix(), applied consistently to all four aside types. All four variants (tip, danger, caution, note) now receive both resting and hover treatments. The specificity cascade is correct — aside-scoped rules win over the global .sl-link-card:hover .title rule. The .sl-markdown-content a:hover exclusion update correctly prevents the generic link-hover style from interfering with link cards. No regressions or omissions detected.

No files require special attention.

Important Files Changed

Filename Overview
docs/ensnode.io/src/styles/starlight.css Adds per-aside CSS custom properties and unifies link-card hover styles across all four aside types; no logic errors found.

Reviews (3): Last reviewed commit: "Merge origin/main into docs/linkcard-asi..." | Re-trigger Greptile

@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io June 3, 2026 07:46 Inactive
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io June 3, 2026 07:46 Inactive
@notrab
Copy link
Copy Markdown
Member Author

notrab commented Jun 3, 2026

@greptile-apps review again

Resolved conflict in docs/ensnode.io/src/styles/starlight.css: kept the
.sl-link-card exclusions on the markdown-link hover rule and main's added
.omnigraph-required-table-content selector.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 3, 2026 07:48
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment on lines +106 to +110
--aside-caution-card-border-hover: color-mix(
in srgb,
var(--aside-caution-color) 70%,
transparent
);
Copy link
Copy Markdown
Member

@lightwalker-eth lightwalker-eth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@notrab Great style improvements! Nice work 😄 Please take the lead to merge when ready 🫡

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants